home *** CD-ROM | disk | FTP | other *** search
/ GRAVIS Top 100 #5 / GRAVIS CD No5_Herbst_95.cdr / GRAVIS / PD ⁄ Shareware / PowerBook / HandyMan 1.1 / HandyMan.readme < prev   
Text File  |  1995-07-06  |  15KB  |  302 lines

  1.  
  2.  
  3.  
  4.  
  5. HandyMan 1.1 (06-07-95) Copyright © 1995 Bert Wynants
  6.  
  7.         Introducing HandyMan
  8.  
  9.         System requirements
  10.  
  11.         How to use HandyMan
  12.  
  13.         The configuration menu
  14.  
  15.         About the program
  16.  
  17.         About the author
  18.  
  19.         Frequent asked questions
  20.  
  21.         Known problems
  22.  
  23.         Program History
  24.  
  25.  
  26. Introducing HandyMan
  27.  
  28.     HandyMan is a Control (Desktop) Strip Launching Module. It is designed to allow quick and easy access to applications, Control Panels, Desk Accessories, Folders and other documents stored on your Macintosh, without having to navigate through several “Finder Windows” or through a multi-layered, hierarchical apple menu.
  29.  
  30. System Requirements
  31.  
  32.     HandyMan should run on any Macintosh model and requires at least system 7.1 and Control Strip or Desktop Strip (version 1.1.1 or higher) installed.
  33.  
  34.     Make sure the “Finder Scripting Extension” is installed to work with Folder icons, Trash icons, Control Panel icons, and ordinary documents ...
  35.  
  36.     If Drag Manager 1.1 is installed you can drag and drop documents on the applications, folders and trash icons in the strip. (System 7.5 has the Drag Manager included).
  37.  
  38.     For complete functionality you need the “Finder Scripting Extension” version 1.2 or higher, “Macintosh Drag and Drop” version 1.1 or higher and “Desktop Strip” control panel version 1.1.1 or higher .
  39.  
  40.     Should you have any trouble running HandyMan on your machine, please write to me with the full specifications of your machine and what version of HandyMan you are using.
  41.  
  42. How to use HandyMan
  43.  
  44.     It is designed to allow quick and easy access to applications, Control Panels, Desk Accessories, Folders and other documents stored on your Macintosh by clicking on the icons or dropping documents onto them. This approach is much handier than aliases that are on the desktop because the strips what contain the icons can never be covered by windows.
  45.  
  46.     HandyMan is configured by dropping aliases in a configuration folder (or by dropping files onto the (+) applescript).
  47.  
  48.     There are a few simple modifier keys that can be used:
  49.         - Option click on the trash will empty it
  50.         - Option drop on a folder copies the files, otherwise they will be moved.
  51.         - Shift clicking on a folder icon filter out non folder from that folders popup menu.
  52.         - Control clicking on a folder icon filter out folder from that folder popup menu.
  53.  
  54.     Desktop Strip Users should put this module into its own strip (folder).
  55.  
  56.     Use compiled Apple Scripts, onto which you can drag and drop just like onto an application, to add any custom command you like to the strip. Base your script on the ' Add Alias' script included in this distribution which shows the drag and drop usage.
  57.  
  58.     An example Setup:
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90. The configuration menu
  91.  
  92. Small icon size
  93. Large icon size
  94.     You can figure out what this means...
  95.     BTW does anyone want to have mini icons?
  96.  
  97.     Large icons are only available in Desktop Strip!
  98.  
  99. Show Popup Triangle
  100.     HandyMan has the ability to hide the configuration triangle to save some space on your desktop (or because it's neater without that triangle).
  101.     You can always use Command click on the module to make it show it's configuration menu and change the settings.
  102.  
  103. Vertical icon list
  104.     The list of icons can be horizontally or vertical arranged.
  105.  
  106.     This option is only available in Desktop Strip!
  107.  
  108. Folder Structure
  109.     To configure the strip, you must make a folder “HandyMan Aliases” in the folder where HandyMan is or in your preference folder. To make multiple columns you can put folders in the  “HandyMan Aliases” folder and put on the “Folder Structure” option.
  110. This way folders are parsed one level deep, folders in those folders show up as folders in the bar (for more information see included picture). To surpress the adding of a folder make the first letter of its name with a ‘¬’ (Option - ‘L’). 
  111.  
  112.     This option is only available in Desktop Strip!
  113.     
  114. Show InfoBar
  115.     Let HandyMan tell you what item the mouse is on.
  116.  
  117.     This option is only available in Desktop Strip!
  118.  
  119. Show Tiles
  120.     Icons are shown with a small frame so they look more like buttons.
  121.  
  122.     This option is only available in Desktop Strip!
  123.  
  124. Resolve Dragged Alias
  125.     This only applies to installed applications.
  126.  
  127.     It makes the application open the alias or the document the alias points to.
  128.  
  129.     This requires “Macintosh Drag and Drop” version 1.1 or higher to be installed.
  130.  
  131. Enable Items Popup
  132.      HandyMan has the ability to let you select a file that is in a folder in a popup menu. Enable this option and click and hold onto the folder or folder alias installed in the bar.
  133.  
  134.     If you have the ‘Apple Menu Options’ control panel installed and 'Remember Recent used files' is on HandyMan will put up a popup menu on your installed applications, containing the recent files that the application can open.
  135.  
  136. (P.S. you can also make the folder yourself (“Recent Documents” in the apple menu) and put some aliases in it and you also can lock aliases in that folder to have permanent items).
  137.  
  138. Enable Drag From
  139.     If on Items can be dragged from the bar away. Handy if you have an alias installed to the 'Find Original' script from apple.
  140.  
  141.     Also see known problems at the bottom.
  142.  
  143.     This requires “Macintosh Drag and Drop” version 1.1 or higher to be installed.
  144.  
  145. Update icon list
  146.     Will re-parse your configuration menu and update all links.
  147.  
  148. About HandyMan
  149.     Guess what...
  150.  
  151.  
  152. About the program
  153.  
  154. Current version 1.1b14
  155.  
  156.     This program is freeware (although a postcard is appreciated), this means that you can copy it freely as long as you don't ask any more money for it than a nominal fee for copying. If you want to distribute this program you should keep this document with it.  This program cannot be used for commercial purposes without written permission from the author.
  157.  
  158.     HandyMan has proven to be stable in everyday use.  The author is not responsible for any loss of data, damages to software or hardware that may result directly or indirectly from the use of this program.  The author reserves the right to make changes to the software or documentation without notice.
  159.  
  160.     None of the files of the HandyMan package may be modified.  Crunching or achieving is allowed only if none of the HandyMan files get modified by it.
  161.  
  162.     Special permission is hereby granted to include HandyMan in Public-Domain libraries.
  163.  
  164.     Permission is also granted to Men & Mice to include HandyMan in their Desktop Strip package.
  165.  
  166. About the Author
  167.  
  168. bugs, questions, or suggestions to:
  169.  
  170. Fido (home)
  171.   2:292/603.76
  172. e-mail (home)
  173.   Bert.Wynants@p76.f603.n292.z2.fidonet.org
  174. e-mail (work)
  175.   bwynants@eps.agfa.be
  176.  
  177. snail-mail:
  178.   Bert Wynants
  179.   Hogeheide 6
  180.   2260 Westerlo
  181.   Belgium, Europe
  182.  
  183. Frequent asked questions
  184.  
  185. Q:Why doesn't drag and drop work?
  186. A:Your system does not have Macintosh Drag and Drop 1.1 or your finder isn't drag and drop aware. You should upgrade to at least Finder version 7.1.2 for powerpc or 7.1.3 for 68k Macs.
  187. Finder 7.1.3 comes with System 7 Pro, and Finder 7.1.4 comes with System 7.5.
  188.  
  189. In this case you will not be able to drag Finder icons onto the icons.  If you try, the icons will not highlight when you drag over them, and nothing will happen when you drop something on an icon.
  190. You can get Mac Drag & Drop 1.1 via anonymous ftp at ftp.support.apple.com/pub/Apple SW Updates/US/mac/System Software/Other System Software/
  191.  
  192. Q:Do I (really) need the scriptable finder?
  193. A:No, but if your system lacks the Scriptable Finder, some varieties of icons will not work. In fact, they usually won't be added to the strip.  Folder icons, Trash icons, Control Panel icons, and ordinary documents require the Scriptable Finder in order to be fully operational. 
  194. The Finder Scripting Extension 1.2. comes with System 7.5, and you can get it via anonymous ftp at ftp.support.apple.com/pub/Apple SW Updates/US/mac/System Software/Other System Software/.
  195.  
  196. Known problems:
  197.  
  198. •dragging an icon from HandyMan on a dragable window of the current application fails  (drag manager bug). I didn't removed the Enable Drag From option because dragging an icon from handyman works very well if you stay in the strip, and can be useful to drop it onto one of the handyman icons.
  199. •no error reporting for apple events.
  200. At this moment I don't know how to receive the result of an apple-event in the module. This means if you drop something onto a folder and the file was already in that folder the move or copy won't work. When you copy you will see that the file doesn't disappear from it's original place. When you copy a file you won't see the copy progress bar from the finder.
  201.  
  202. Program History
  203.  
  204. Version 1.0d0
  205. •initial release
  206.  
  207. Version 1.0d1
  208. •many thanks to Sigurdur Asgeirsson for helping on drag and drop.
  209. •added custom Finder icon recognition
  210.  
  211. Version 1.0d2
  212. •Added possibility to add Folders, Trashes and Documents
  213. •Faster parsing of icons
  214. •Retrieving Icons From Desktop DataBase
  215. •Added menu item to show or hide popup arrow
  216. •Added folders parsing in preferences folder, these can be used to group your applications
  217.  
  218. Version 1.0d3
  219. •Aliases folder can now reside in the module's folder in a folder called  “HandyMan Aliases”
  220.  
  221. Version 1.0b4
  222. •renamed to HandyMan.
  223. •Control Strip support added (although Desktop Strip works much better)
  224. •each invocation of HandyMan has separate preferences.
  225.  
  226. Version 1.0b5
  227. •No more crashing if Drag manager is not installed. (reported by Peter Frings)
  228. •No more showing of invisible files. (reported by Peter Frings)
  229. •better icons for desk accessories. (reported by Peter Frings)
  230. •uses system icons for default icons...
  231.     
  232. Version 1.0b6
  233. •Fixed bug for MacApp Applications, they accept a drop now without a program error...
  234.  
  235. Version 1.0b7
  236. •Using Finder label now for coloring...
  237. •Added an optional info Bar...
  238. •Added an About Menu Item...
  239.  
  240. Version 1.0b8
  241. •Fixed bug that messed up icon positioning if some configuration folders where empty
  242. •Fixed bug that caused crashes with a very narrow info bar  (reported  by Petur Petursson and thanks go to Angela for "borrowing" here Mac)
  243. •Fixed problem with aliases to documents or applications on other disks.
  244. •They are now updated as soon as the Finder has mounted those volumes, if you are annoyed by the fact is shows a generic icon for a while, then give those files a custom icon...(reported  by Petur Petursson & Peter Frings)
  245. •Added Option Click on trash to empty it (Asked by Chris Bastiaens)
  246.  
  247. Version 1.0b9
  248. •No longer gets to front when asked to empty the Trash
  249. •Fixed bug that sometimes messed up Info bar (introduced in the 1.0b8)
  250. •Fixed bug that sometimes caused the bar to get empty after an update icon list
  251. •If scriptable finder is not installed, only applications are added (Sugg. Koen Van de Poel)
  252. •Fixed problem with aliases to documents or applications on other disks if you have a lot of Disks connected, The fix from b8 only worked for 1 external disk.
  253. •Fixed problem that sometimes caused the Icon List to become empty (reported  by Petur Petursson)
  254. •Added Recent Files popup to application (optional)
  255. •Dropping files on an open application was broken in the b8 revision, it's fixed again.
  256.  
  257. Version 1.0b10
  258. •Fixed recent files popup :-)
  259.  
  260. Version 1.0
  261. •Really Fixed problem with aliases to documents or applications on other disks if you have a lot of Disks connected. A note on this one: as long as there are generic icons for documents or applications HandyMan watches Disk Inserts and tries to get the icons from the inserted disks. If you have apps or docks that really have a generic icon you better paste a custom icon onto them to stop HandyMan scanning inserted disks (although it won't heart watching the Disks)
  262.  
  263. Version 1.1b12
  264. •Fixed about in Control Strip.
  265. •Start dragging from strip as soon as you leave the selected icon's bounds if popup recent files is on.
  266. •Altough the docks say so 1.0 never looked in the preference folder for handyman files, this is fixed now.
  267. •if Apple Menu Options was not installed, and the option popup recent files was active, no menu showed up after clicking an application and the icon became unselected. Now always a menu  will show up with at least a Launch item in. (Thanks to Peter Frings for reporting)
  268. •Small bug fixed in Update Icons.
  269. •Added Popup for folders (default everything is shown, pressing shift means no files, pressing control means no folders, pressing both shows nothing ).
  270. •Animation on Trash added.
  271. •Opening a control panel or desk acc. now brings finder to front.
  272. •Better support for screens in black and white mode.
  273. •Added Tiling option.
  274. •reorganized preference menu.
  275. •Drags from the system 7.5 'find file' window are accepted now.
  276. •Trashing a list of files is much faster now, the current speed can only improve if apple make a better scriptable finder :-(
  277. •dropping a document on itself also works now, it opens the document...
  278. •It no longer asks for Ejected disks if there are some when updating icons.
  279. •AppleEvents work always now, also if front application doesn't know about appleEvents.
  280. •AppleEvents made a bit more reliable (hope this fixes your problem Joseph).
  281. •Info Text automatic jumps to condensed if it doesn't fit
  282. •folders are added too ( unless the first letter is a '¬' (option-L)
  283. •slightly faster icon parsing
  284. •Better detection of disk drops on trash
  285. •cmd key always shows configuration popup menu (Request from Angela McCormack)
  286. •added ‘ Add Alias’ script, put a copy of it in each folder you make in the “HandyMan Aliases” folder, dropping a file on it will put an alias at an automatic configured place. You only need to select Update Icons after the drop. This script also serves as an example for dropping on a script.
  287. •reduced Module Size :-)
  288.  
  289. Version 1.1b13
  290. •Made handyman a bit smarter about finder scripting (Request from Boris Groendahl). If the Mac starts up with rebuilding the desktop you still need to select update icons manually after it has finished. When all icon's are visible, they won't disappear anymore by rebuilding the desktop and selecting update icons at the same time.
  291. •looking for the original of an alias surpresses the logon box now. it freezed the system! (report from Kristof Vanbecelaere). If possible HandyMan passes the request onto the finder, this means clicking on a folder to mount a volume still works!
  292. •improved sensitivity to differentiate between drag from and popup on item...
  293. •dropping handyman's own dragged icon onto itself fixed.
  294. •updated docs to this version.
  295.  
  296. Version 1.1
  297. •Cosmetic fix for combination of no icons and info bar option on.
  298. •Cosmetic fix for info bar on B/W screens (end was sometimes messed up).
  299. •Added limited Folder support if “Finder Scripting Extension” is not installed.
  300.  
  301. ToDo:
  302. •Use module name for aliases folder name (multi module in one strip)